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1. INTRODUCTION 



BASIC PROGRAMMING is an in- 
structional tool designed to teach 
you the fundamental steps of com- 
puter programming. BASIC is an 
acronym for Beginners All-purpose 
Symbolic Instruction Code. It was 
originated so that people could 
easily learn to "write" computer 
programs. 

Computer programs are simply a 
series of instructions. The pro- 
grams control the flow of informa- 
tion within the computer. BASIC 
PROGRAMMING allows you to 
give the Video Computer System 



the instructions it needs to carry 
out some simple tasks. 

Keep in mind that BASIC PRO- 
GRAMMING has a limited amount 
of memory in comparison to more 
sophisticated computer systems. It 
is, however, an excellent instruc- 
tional device for learning the essen- 
tials of computer programming. 

NOTE: This Game Program™ car- 
tridge may cause some television 
screens to "roll" slightly. If this oc- 
curs, adjustment of the VERTICAL 
HOLD may be necessary. 



2. USING THE CONTROLLERS 




\ 



Use your Keyboard Controllers 
with this ATARI® Game Program 
cartridge. Be sure the Keyboard 
Controller cables are firmly 
plugged into the RIGHT and LEFT 
CONTROLLER jacks at the back 
of your ATARI Video Computer 
System™ game. See Section 3 of 
your owner's manual for further 
details. 



To connect the two controllers, 
slide the tongue of the left con- 
troller into the groove on the right 
controller. The two Keyboard Con- 
trollers, locked together, form a 
24-key keyboard used to enter 
your program and to control the 
display on your television screen. 

Remove the Keyboard Controller 
labels from the envelope. Place 
the label marked LEFT over the 
Keyboard plugged into the LEFT 
CONTROLLER jack at the rear of 
your computer console. Place the 
label marked RIGHT over the 
Keyboard plugged into the RIGHT 
CONTROLLER jack at the rear of 
your computer console. 
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3. CONSOLE CONTROLS 



GAME SELECT SWITCH 

Press game select to erase a 
program and reset all values. 

GAME RESET SWITCH 

Pressing the game reset switch 
erases all values and returns a pro- 
gram to its beginning without eras- 
ing the program. 

DIFFICULTY SWITCHES 

Before beginning your program, 
place the left difficulty switch in 
the b position. This will show you 
where each region is on your dis- 
play. When the left difficulty 



switch is placed in the a position, 
the titles of each region will disap- 
pear from the display and the 
GRAPHICS region will come into 
view. 

The right difficulty switch has no 
function in this Game Program car- 
tridge. 

TV TYPE SWITCH 

Set this switch to color if you have 
a color television set. Set it to b-w if 
you are using a black and white 
television set. 
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4. DISPLAY REGIONS 



The display is divided into six 
regions: 

1 . The PROGRAM region is used 
to give the computer your 
instructions. 

2. The STACK region will give you 
the temporary results of your 




program as the computer is 
running it. 

3. The VARIABLES region will 
give you the value of each 
variable item in your program 
as it is being run. 



4. The OUTPUT region will show 
you the output being produced 
as your program is being run. 

5. The STATUS region shows you 
the amount of memory 
available at any time for your 
program. This region will also 




give you the speed of execution 
of your program. 

6. The GRAPHICS region has two 
colored squares which can be 
moved around under your pro- 
gram control. 



5. THE CURSOR 



Place the left difficulty switch 
into the b position and turn your 
console off and then on again. In 
the PROGRAM region there is a 
white rectangle. This is the cursor. 
Locate the shift control key at the 
center of the bottom row on the 
left controller. Push this key four 



times. The color of the cursor will 
change from white to red, from red 
to blue, from blue to green, and 
from green to white again. 

The cursor is used to input your 
program. Each of the four colors 
on the shift key corresponds to the 
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colored commands or inputs on 
your Keyboard. The white mode is 
used to give your computer com- 
mands, the other modes are used 
to insert symbols into your program. 

MOVING THE CURSOR FROM 
REGION TO REGION 

Make sure the left difficulty 
switch is in the b position and turn 
your console unit off and then on 
again. Push the FORWARD key 
and the cursor will move from 
PROGRAM to STACK. Push the 
FORWARD key again and the cur- 
sor will move from STACK to 
VARIABLES. Push the key again 
and the cursor will move from 
VARIABLES to OUTPUT. 

By pushing the BACKWARD key 
you can move the cursor back to 
the PROGRAM region. The FOR- 
WARD and BACKWARD keys can 
be pushed once for each region or 
held down. 

Now place the left difficulty 
switch into the a position. The 
titles of each region will disappear 
and a portion of the GRAPHICS 
region will appear. Step the cursor 
through each of the regions again. 
Notice that the cursor will not 
move into the GRAPHICS region. 

REMOVING THE REGIONS 
FROM THE DISPLAY 

Place the left difficulty switch 
into the b position again and turn 
your console unit off and then on. 
On the left side of the Keyboard 
are a series of commands (white 
mode) that correspond with each 



of the regions: STATUS, PRO- 
GRAM, STACK, VARIABLES, 
OUTPUT, and GRAPHICS. Let's 
start with the STATUS region. 
Push the STATUS key once and 
the STATUS region will disappear 
from the screen and the PRO- 
GRAM region will move to the top 
of the display. 

Push the PROGRAM key and the 
PROGRAM region will disappear 
and the STACK region will move 
to the top of the display. Push the 
STACK key and the STACK region 
will disappear and the 
VARIABLES region will move to 
the top of the display. Push the 
VARIABLES key and the 
VARIABLES region will disappear 
causing the OUTPUT region to 
move to the top of the display. 

Remove the OUTPUT region by 
pushing the OUTPUT key. This will 
also cause the GRAPHICS region 
to be fully visible on the display. 
Push the GRAPHICS key to 
remove the GRAPHICS region. 
Your display should show no regions. 

Now push the STACK key. The 
STACK region will reappear on 
your display. Remove the STACK 
region, and bring up the OUTPUT 
and VARIABLES regions. You 
may display or remove any region 
with the left difficulty switch in 
either the a or b position. 

It is important to note that whether 
or not the various regions are dis- 
played has no effect on the execu- 
tion of a program. 
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6. RUNNING A PROGRAM 



Let's do a simple program. Make 
sure the left difficulty switch is in 
the b position and turn your con- 
sole unit off and then on again. 

Remove the STACK, VARIABLES, 
OUTPUT, and GRAPHICS regions 
from the display. The cursor will 
be in the white mode and to the 
right of the number 1 in the PRO- 
GRAM region. Change the cursor 
to the blue mode and push the A 
key. The letter A will appear on the 
display next to the 1 . (Each line is 
numbered, making it possible to 
see where one line ends and the 
next one begins.) Now change the 
cursor to the red mode and push 
the «- key. A small arrow will ap- 
pear next to the A. Now go back 
to blue and input B. Changing the 
cursor to red, input + and the 
number 2. Now go back to the 
white mode and input New Line. 
You must always be in the white 
mode in order to start a new line 
in your program. 

Your display should look like this: 





If you make an error in entering 
your program, it can be erased us- 
ing the ERASE key. Notice that 
the ERASE key is not color cod- 
ed. It can be used when the shift 
key is in any color mode. 
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Using the line that you have just 
entered into your program, let's do 
an exercise. Push the ERASE key 
once. The cursor will move from 
line 2 directly to the right of the 2 
on line 1. Push the ERASE key 
again and the 2 will be erased 
from the program. Now enter 1, 
using the red mode. Change the 
cursor to the white mode and us- 
ing the BACKWARD key, move 
the cursor until it is directly to the 
right of the B in the program. Push 
the ERASE key and the letter will 
be removed from the program. 
Now replace it with A (blue mode). 
In the white mode, use the FOR- 
WARD key to move to the end of 
line 1 and input New Line. 

Remember that the cursor should 
not be on the symbol to be erased 
but directly to the right of it. Your 
screen display will now look like 
this: 



The cursor is directly to the right 
of the 2 in line 2. Now input 
PRINT using the green mode. 
Then, with the blue mode, input A 
and go to a New Line. Your 
display will look like this: 




Now, with the cursor in the green 
mode, input GOTO and then, in 
the red mode, input 1 . Before we 
do anything else, let's look at the 
display again. 
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Notice that the STATUS region 
shows we have 52 "bytes" or 
symbols of memory remaining. The 
SPEED is set at 30 (SPEED = 30). 
Put the cursor into the white mode 
and press the SLOWER key. 
Notice that every time you press 
the key the speed decreases. 
Press the FASTER key and the 
SPEED will increase. 

Before we start the program, input 
SPEED = 1. Now press the STACK 
key. Press the RUN/HALT key 
twice and the program will begin. 
You can watch the computer work 
each part of the program. 




To stop the program press 
RUN/HALT. As noted before, 
pressing the game reset switch 
erases all values in your program 
(without erasing the program 
itself), and returns the program to 
its beginning. 

Let's analyze the program step by 
step as the computer runs through 
it. Change SPEED to 60. With the 
cursor in the white mode press the 
STEP key. This will take each part 
of the program one step at a time, 
each time it is pressed. 

In line 1 the program reads A — A 
+ 1. The computer reads this as 
A "becomes" A + 1. Watch the 
STACK region as you step through 
line 1. In line 2, you have told the 
computer to Print A. This means 
you want the computer to print the 
value of A (as determined by line 
1) in the OUTPUT region. 

We'll see how that works later. 
Line 3 tells the computer to Goto 
1 . The computer is to return to line 
1 and find a new value for A. Each 
time the program is run through it 
will find a new value for A, print 
that value, and then return to line 
1. The computer will continue to 
run through the program in this 
manner until all the "memory" is 
used. The amount of remaining 
memory is shown in the SYM- 
BOLS area of the STATUS region. 

Bring up the VARIABLES region 
on the display. Change the SPEED 
to 1 and clear the values of the 
program by pressing the game 
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reset switch. Push the RUN/HALT 
key and watch as the computer 
runs through the program. The 
computer will show you the cur- 
rent value of A at each step of 
your program. Your screen display 
will look like this: 




Stop the program and clear the 
values (game reset). Remove the 
VARIABLES region and bring up 
the OUTPUT region on the display. 
Change SPEED to 60. The display 
will now look like this: 




Press the RUN/HALT key and 
start the program. In line 2, the 
computer is instructed to PRINT 
A. When it reaches this command, 
it will print the current value of A 
in the OUTPUT region. Watch the 
SYMBOLS area of the STATUS 
region. Even though 1 shows in the 
OUTPUT region on your display, 
the computer is still printing the 
changing value of A. Put the left 
difficulty switch in the a position. 
Your display will now look 
something like this: 
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How can we show more of the 
OUTPUT region on the display? 
Remove the STATUS, PROGRAM, 
and STACK regions from the 
display. Your display will look like 
this: 



Using the FORWARD key, move 
the cursor to the end of line 1 , so 
that your display looks like this: 





Suppose we don't want to over- 
load the OUTPUT region of the 
program? Stop the program and 
erase the values with the game 
reset switch. Remove the OUT- 
PUT region from the display and 
bring up the PROGRAM region. 



Now press the NEW LINE key. 
We will insert a new command 
here. Input CLEAR (green mode). 
Your display will look like this: 
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Bring up STACK, VARIABLES and 
OUTPUT. Leave the left difficulty 

switch in the a position and start 
the program. As the program 
passes line 2 CLEAR it erases the 
value of A in the OUTPUT region 
and then prints the next value of A 
in line 3. 



BASIC PROGRAMMING can only 
work with two-digit numbers, so as 
it reaches 99 it will "wraparound" 
and begin again showing A's value 
to be 0. 



7. USING THE NOTE FUNCTION 



Each time the program stores a 
number into NOTE (red mode), a 
note from the musical scale will be 
sounded by your television 
speaker. 

Let's do some programs to demon- 
strate. If you have any programs in 
your Video Computer System, 
press the game select switch on 
the console unit. 

Input the following: 

1 Note *- Note + 1 

2 Goto 1 

Now start the program. Slow the 
program down and watch it being 
worked in the STACK region. Also 
notice that the program will print 
the current value of NOTE in the 
VARIABLES region. 



Stop the program and insert a new 
line 2 (in the white mode, move 
the cursor to the end of line 1 and 
press NEW LINE. The previous 
line 2 will become line 3). 

2 If Note > 6 Then Note - 

Your display will look like this: 
(If STACK and VARIABLES 
regions are removed.) 
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With the IF and THEN commands, 
we are instructing the program 
that IF something happens THEN 
it is to do something else. In this 
case, IF Note is more than 6, 
THEN Note is to be changed to 0. 
Start the program and watch it be- 
ing worked in the STACK region. 
Notice that as the value of Note 
reaches 7, it becomes more than 
( >) 6 and the program changes 
the value to 0. 

Let's do another program to 
achieve the same result in a dif- 
ferent way. Input the following: 




Run the program. Notice that the 
same results are achieved, except 
that the notes are spaced evenly. 
If you want the program to give 
you the value of C in the OUTPUT 
region, input Print C and Clear as 
instructions anywhere in the pro- 
gram. To cut down on the flicker in 
the OUTPUT region as the pro- 
gram is giving you the value, insert 
a comma, (green mode) after the 
value in the Print line, Print C. 

You may use any letter of the 
alphabet for the variable in your 
programs. The following program 
has all the key functions we have 
learned so far and uses nearly all 
the available "memory" in the 
computer. After entering this pro- 
gram, remove the program from 
the display, bring up the STATUS, 
STACK, and OUTPUT regions, 
and run the program. 







In this program we have given two 
IF/THEN commands. If the condi- 
tions set up in the first command 
are not met (line 4) the computer 
will move to the next line (line 5). 
Given enough memory, there can 
be several commands between 
any two IF/THEN commands. 



1 1 



In some cases we can put two 
commands on one line, as in line 1 
and line 2 in the above program. In 
this way we can save some of the 
memory for later in the program. 



:r, 



AND PUNT FUNCTIONS 



The KEY function (red mode) is 
used to input a variable while the 
program is running. The program 
will evaluate KEY and replace it 
with a number that you input from 
the right side of the Keyboard. If 
no number is inputted, then the 
program will read KEY as 0. 

Here's a simple program using the 
KEY function: 




Start the program and push some 
of the keys on the right side of the 
Keyboard. With practice you may 
be able to play a tune. 

The KEY function can also be 
used for programming in the 
GRAPHICS region as we will see 
later. 

Try this program using the KEY, 
NOTE, and PRINT functions: 
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Watch this program in the OUT- 
PUT region. Notice that as you In- 
put a number from the right side of 
the Keyboard the program will play 
that tone and display that number 
in the OUTPUT region. 



Now let's make a minor modifica- 
tion in the program. In line 2, in- 
sert a comma (,) after Print A and 
start the program. By inserting the 
comma here you have told the pro- 
gram that you want as many of the 
variables printed on one line as 
possible. 




9. USING THE PRINT FUNCTION 



As we showed in earlier programs, 
you can use the PRINT function to 
instruct the program to print the 
value of a variable in the OUTPUT 
region. The PRINT function can 



also be used to instruct the pro- 
gram to print words on the display. 
Words to be displayed must be 
enclosed in quotation marks ("). 
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Set the SPEED at 8 and input the 
following program: 



Let's change the program slightly 
by inputting a comma (,) at the end 
of line 1 and line 2. The program 
now looks like this: 




Now run the program and watch 
the OUTPUT region. The program 
prints the word you have inputted, 
but they are "stacked." 




The comma (,) in line 1 has in- 
structed the program that what- 
ever is on line 2 is to be displayed 
in the OUTPUT region on the 
same line as the instruction on line 
1 . The comma in line 2 has in- 
structed the program that the line 
3 instruction is to follow line 2. 
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These instructions can be shorten- 
ed by changing the program to 
read: 



The program can be further 
shortened: 





Writing the program in this fashion 
will also save some memory. 



0. USING :^HE GRAPHICS REGION 



The GRAPHICS region is the blue 
rectangular field on your television 
screen. At first glance it appears 
to contain one red square in the 
upper left corner. The red square 
actually covers a white square and 
both may be moved independently 
on the field under your program 
control. 



To move the squares you must 
change their coordinates. The red 
square is object number 1. Its 
horizontal coordinate is repre- 
sented on the Keyboard by Ho r 1 
and its vertical coordinate by Ver 
1. Hor 2 and Ver 2 are the coor- 
dinates of object number 2, the 
white square. 






Both objects or squares start out 
in the upper left corner of the blue 
field, with only the red square 
showing. The upper left corner is 
the zero (0) position or origin. 
When the variables Hor 1, Ver 1, 
Hor 2, and Ver 2 are not defined 
(given values) they have values of 
(therefore causing the squares to 
remain in the upper left corner 
position). 

When a coordinate is assigned a 
value other than 0, (e.g. Hor 1 — 
10), the object involved will jump 
to the corresponding position on 
the blue field when the program is 
executed. 

Input the following program: 







This program will move the red 
square to the right, one horizontal 
space at a time. Run this program 
and you will see the red square 
moving slowly to the right. Check 
the VARIABLES region and you 
will see the value of Hor 1 increas- 
ing. It will increase until it reaches 
99, the largest number allowed, 
and then drop back to 0. When 
Hor 1 reaches 99, the red square 
will have reached the far right side 
of the blue field. At this point, the 
red square "wraps around" and 
starts again from the far left side 
of the field, with Hor 1 at 0. 

The horizontal coordinates (Hor 1 
and Hor 2) then, range from to 
99. The vertical coordinates (Ver 1 
and Ver 2) also range from to 
99, with being the position at the 
top of the blue field, and 99 being 
the position at the bottom. 

Input the following program: 













™ J. Hdi-jL«e- 


Hdi- 


1+6 


1 ■ 2 VErl^- 


Ubi- 


A+8 1 


■" 3 Hor 2 *- 


Hnr 


2 + 4 I 


^T™ "* '■■'ei-2«=- 


Wei- 


2 + 4 


|" 5 If HiTThEnNntH.H-2 


m m E| 5B MnTE*- 


V 






■ e Goto j. 
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Remove the program from the 
screen and make sure the 
GRAPHICS region is fully visible. 
Set the speed at 60 and run the 
program. This program shows you 
one way to move the squares on 
the field. It also reveals how the 
HIT and ELSE functions may be 
put to use. 

In line 5 the program is instructing 
the computer to sound the 2 note 



IF the squares HIT, which they do 
periodically. To HIT means the 
squares must occupy the same 
coordinates. Otherwise (ELSE) the 
computer is instructed to play the 
7 note, which it will do until the 
squares hit. 

(Remove ELSE NOTE — 7 from 
line 5 and note 2 will be played 
when the squares hit and no other 
note will be sounded.) 



1 1 . USING THE MOD FUNCTION 



1. X + (Highest) 

2. + - 

3. Mod 

4. = 

5. *- (Lowest) 

Using Parenthesis 

Using parenthesis (green mode, 
left side of Keyboard), gives prior- 
ity to whichever numbers the 
parenthesis surround when work- 
ing out an equation. 

For example, when working out 
the following equation: 



A 5 + 3 x 2 Mod 7 

the first step is: 3 x 2 = 6 
the second step is: 5 + 6 = 1 1 
the third step is: 1 1 Mod 7 = 4 
A = 4 

However, the same equation with 
parenthesis inserted, is worked out 
differently and gives a different 
answer for A. 

A (5 + 3) X 2 Mod 7 

first step: 5 + 3 = 8 
second step: 8 x 2 = 16 
third step: 16 Mod 7 = 2 
A = 2 



Mod is an arithmetic operator, 
much like the division operator 
(+). BASIC PROGRAMMING 
employs integer division, which 
means it works with whole num- 
bers only, and leaves no re- 
mainder. For example, what is 14 
+ 5? You might say 2 and 4/5, or 
2, remainder 4. In BASIC PRO- 
GRAMMING 14 + 5 is 2. 
Although 5 divides into 14 twice 
(making 10), with 4 left over, 
BASIC uses whole numbers only, 
so the answer it gives you is 2. 

The computer will give you the 
same answer for 12 + 4 as it will 
for 1 3 + 4. The answer in both in- 
stances is 3, since 4 will divide 
into both 12 and 13, 3 whole 
times. The computer will not 
recognize the remainder of 1 in 
the case of 1 3 ■+• 4. 

Now for the Mod function. Mod 
gets the remainder left over after 
dividing the first number into the 



second number. So, 14 Mod 5 is 
4. Five divides into 14 twice (mak- 
ing 10) with 4 left over. Mod gets 
the remainder left over, therefore 
Mod is 4. 

What is 13 Mod 4? The answer is 
1 since 1 is left over after dividing 
4 into 13 (which makes 12). How 
about 12 Mod 4? In this case, 
Mod is since 4 divides into 12 
evenly with nothing or remaining. 

Normally, dividing by is undefin- 
ed, mathematically speaking. In 
BASIC PROGRAMMING, dividing 
by just gives a result of 0, so 
that 5 + is 0. 

Operator Priorities 

In an equation, the arithmetic 
operators (+, -, x, + Mod, 
etc.) are worked out in order of an 
established priority. BASIC PRO- 
GRAMMING uses the following 
operator priority guide: 



12. SAMPLE PROGRAMS 



Here are some sample programs. 
They will help you see the wide 
range of possibilities you have to 
work with. Remember to pay close 
attention to how a particular com- 
mand (IF, THEN, HIT, ELSE, 
PRINT, KEY, etc.) affects a pro- 
gram. Remember too that a KEY 
command may depend on your in- 
put from the right side of the 
Keyboard for successful operation 
of the program. 

Whenever a particular program 
confuses you, stop the program, 
reset it to the beginning, and 
STEP through it. By watching the 
program in the STACK region and 
seeing how the computer works 
out each step, you should be able 
to understand what is happening 
and why it is happening. 



After running the programs and 
becoming familiar with the fun- 
damentals of computer program- 
ming in general, you'll be well on 
your way toward writing some pro- 
grams of your own. 

HIT 
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ATARr GAME PROGRAM '" INSTRUCTIONS 



ATARP GAME PROGRAM" INSTRUCTIONS 



MUSIC 



CLOCK-LIKE PROGRAM 

When running the Clock program 
bring up the OUTPUT region only. 
The SPEED may be set at 30 or 
60. 



PONG® GAME 
without sound 







PONG® GAME 
(Ball & Paddle) 
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